home *** CD-ROM | disk | FTP | other *** search
/ Shareware Gold 2 / Shareware Gold II - Volume 2 Number 1 - Wayzata Technology (7071) (1991).iso / graphics / gemcap / gemcap.doc < prev    next >
Text File  |  1990-11-29  |  20KB  |  594 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                    GEMCAP (TM)
  17.  
  18.                     4.01
  19.  
  20.  
  21.  
  22.                                    USER MANUAL
  23.  
  24.  
  25.  
  26.  
  27.                             (C) Copyright 1985 - 1990
  28.                                All Rights Reserved
  29.  
  30.                                 Natural Software
  31.                               19 South Fifth Street
  32.                               St. Charles, IL 60174
  33.                                  (708) 377-7320
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.      LICENSE
  56.  
  57.      THE GEMCAP SOFTWARE AND MANUAL ARE COPYRIGHTED, ALL RIGHTS ARE RESE-
  58.      RVED. YOU HAVE PURCHASED A LICENSE TO USE THIS SOFTWARE ON ONE MACHINE
  59.      AT A TIME. YOU ARE AUTHORIZED TO MAKE COPIES OF GEMCAP FOR THE SOLE
  60.      PURPOSE OF BACKING UP YOUR SOFTWARE AND PROTECTING YOUR INVESTMENT
  61.      FROM LOSS.
  62.  
  63.      Note: this copy of GEMCAP is being distributed as ShareWare. This
  64.      means that you may copy the disk just as you received it and you may
  65.      give it to others for their trial use. You are also permitted and
  66.      encouraged to upload this version to electronic bulletin board servic-
  67.      es. You may not, however resell or collect any fee for the distribu-
  68.      tion of GEMCAP without the permission of Natural Software. (This does
  69.      not include the normal fees for using bulletin boards.) If you contin-
  70.      ue to use GEMCAP after your trial use, you must pay the purchase price
  71.      as detailed below.
  72.  
  73.      WARRANTY
  74.  
  75.      THIS SOFTWARE WILL PERFORM AS DESCRIBED HEREIN ONLY IF PROPERLY AP-
  76.      PLIED. OUR LIABILITY TO YOU IS LIMITED TO REPLACING THE SOFTWARE (FOR
  77.      REGISTERED USERS ONLY). WE HAVE NO LIABILITY TO YOU FOR ANY DAMAGE OR
  78.      LOSS, INCLUDING SPECIAL, INCIDENTAL, OR CONSEQUENTIAL, CAUSED BY THIS
  79.      SOFTWARE, DIRECTLY OR INDIRECTLY.
  80.  
  81.      YOU AGREE TO THE TERMS OF THIS LICENSE BY YOUR DECISION TO USE THIS
  82.      SOFTWARE.
  83.  
  84.  
  85.                _______                       This program is produced by
  86.           ____|__     |               (tm)   a member of the Association
  87.        --|       |    |-------------------   of Shareware Professionals
  88.          |   ____|__  |  Association of      (AS). ASP wants to make sure
  89.          |  |       |_|  Shareware           that the shareware principle
  90.          |__|   o   |    Professionals       works for you. If you are
  91.        -----|   |   |---------------------   unable to resolve a shareware
  92.             |___|___|    MEMBER              related problem with an ASP
  93.                                              member by contacting the member
  94.                                              directly, ASP may be able to
  95.      help. The ASP Ombudsman can help you resolve a dispute or problem with
  96.      an ASP member, but does not provide technical support for members'
  97.      products. Please write to the ASP Ombudsman at P.O. Box 5786, Belle-
  98.      vue, WA 98006 or send a Compuserve message via easyplex to ASP Ombuds-
  99.      man 70007,3536"
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.                                 Table of contents
  108.  
  109.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .      1
  110.         ShareWare  . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  111.  
  112.      Using GEMCAP  . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  113.         Starting GEMCAP  . . . . . . . . . . . . . . . . . . . . . . .    3
  114.         The Hot Key  . . . . . . . . . . . . . . . . . . . . . . . . .    3
  115.         Customizing the Hot Key  . . . . . . . . . . . . . . . . . . .    4
  116.         Removing GEMCAP  . . . . . . . . . . . . . . . . . . . . . . .    5
  117.  
  118.      Text Mode Screens . . . . . . . . . . . . . . . . . . . . . . . .    6
  119.         Text mode fonts  . . . . . . . . . . . . . . . . . . . . . . .    6
  120.         Image Size . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  121.  
  122.      Graphic Mode Screens  . . . . . . . . . . . . . . . . . . . . . .    8
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.                                        ii
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.                                   Introduction
  164.  
  165.  
  166.  
  167.      GEMCAP.COM is a Terminate and Stay Resident (TSR) program that cap-
  168.      tures screen images from other programs. It saves these images in
  169.      separate GEM .IMG files. In the case of text based screens, the text
  170.      is converted to a bitmap. The GEM .IMG graphic file format is one of
  171.      the several "standard" formats that many other programs can read. The
  172.      primary use of GEMCAP is to incorporate screen images into desktop
  173.      publishing documents. Both Ventura Publisher and WordPerfect version
  174.      5.0 (and 5.1) can read GEM .IMG format.
  175.  
  176.      GEMCAP supports a variety of display adapters and different display
  177.      modes:
  178.  
  179.      Monochrome   Standard IBM monochrome display adapters support text
  180.                   modes only. GEMCAP will capture text mode displays and
  181.                   convert them to bitmap files. To use the resulting .IMG
  182.                   files, however you must have some type of display adapter
  183.                   that can display graphics.
  184.  
  185.      CGA          On IBM Color Graphics Adapters (CGA), the high resolution
  186.                   640 by 200 pixel (mode 6) is supported in addition to the
  187.                   various text modes.
  188.  
  189.      EGA          GEMCAP can capture EGA 640 by 350 pixel 16 color (mode
  190.                   10h) graphics screens.
  191.  
  192.      VGA          GEMCAP can capture VGA 640 by 480 pixel 16 color (mode
  193.                   12h) graphics screens.
  194.  
  195.      Hercules     GEMCAP will not work on Hercules displays in graphics
  196.                   mode. It will capture text mode screens from Hercules.
  197.                   You can use your desktop publishing program to use the
  198.                   resulting GEM .IMG files with Hercules displays.
  199.  
  200.      On EGA and VGA displays in text mode, GEMCAP uses the RAM resident
  201.      font to convert the screen to a bitmap. This means that the resulting
  202.      bitmap represents the captured text screen exactly as it appears on
  203.      the screen, even if the program loads a specialized font.
  204.  
  205.  
  206.  
  207.  
  208.  
  209.      Introduction                                                         1
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.      ShareWare
  218.  
  219.      The GEMCAP package is being distributed as shareware. This means that
  220.      it is not free. This means that you must pay to use it. However, you
  221.      do not have to pay to try it, test it, and to determine if it is going
  222.      to be useful to you. You are probably familiar with the concept by
  223.      now. Shareware programs give you the advantage of "test driving" them.
  224.      The advantage to the developer is a relatively inexpensive distribu-
  225.      tion method. For this concept to work and keep working for our mutual
  226.      advantage, you really must register and pay for the software you
  227.      actually find useful.
  228.  
  229.      Please feel free to pass along a copy of this disk to others for their
  230.      trial use. But please distribute it in its original unaltered state.
  231.      The compressed arc file: GEMCAP.ZIP is intended for uploading to your
  232.      local bulletin boards.
  233.  
  234.      To register your use of GEMCAP, send $35.00 to Natural Software at the
  235.      address above. This entitles you to one upgrade to the next new
  236.      release for free (please specify the version you currently have when
  237.      registering). We will also send you a description of our other soft-
  238.      ware offerings (including PC-Draft II which lets you to edit and
  239.      enhance your captured images) and provide free telephone support as
  240.      needed.
  241.  
  242.      You may use the order form provided in the file: ORDER.FRM.
  243.  
  244.      Please read the file: PRODUCTS.LST for descriptions of other products
  245.      from Natural Software.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      2                                                                GEMCAP
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                                   Using GEMCAP
  278.  
  279.  
  280.      GEMCAP is a Terminate and Stay Resident (TSR) program. When you run it
  281.      from the DOS command line, it will announce its presence and quietly
  282.      sink into the background and wait to be called into action (when its
  283.      "hot key" is pressed).
  284.  
  285.      Starting GEMCAP
  286.  
  287.      When you run GEMCAP, you must provide it with the location and start-
  288.      ing file name to use to store the screen images it captures. For
  289.      example, you might start GEMCAP with this command:
  290.  
  291.              GEMCAP C:\SCREENS\SCREENA.IMG
  292.  
  293.      Now GEMCAP will store its screens in the SCREENS sub-directory. Note
  294.      that the SCREENS sub-directory must already exist. The first screen it
  295.      saves will be called SCREENA.IMG, the second will be called
  296.      SCREENB.IMG. Each subsequent .IMG file will increment the character in
  297.      the filename just before the extension. These files are graphic bit
  298.      image files compatible with any program that reads GEM .IMG files,
  299.      regardless of whether the original screen was in text mode or graphics
  300.      mode.
  301.  
  302.      Note that this convention (of incrementing the last character in the
  303.      filename for each file) limits you to 26 screen saves at a time. This
  304.      is because if you start with the letter A, it will cycle through the
  305.      alphabet until it gets to Z, then the next character in ASCII sequence
  306.      is a "[", which is invalid for a filename. If you need more than 26
  307.      files, you must remove GEMCAP from memory and reload it with a differ-
  308.      ent initial filename.
  309.  
  310.  
  311.      The Hot Key
  312.  
  313.      To activate GEMCAP and save the current screen to a .IMG file, you
  314.      Press the (Alt + .) keys (that's the period key and the Alt key) togeth-
  315.      er. You will hear a beep when GEMCAP is called. Three beeps means it
  316.      successfully wrote an .IMG file to the specified directory. Only one
  317.      beep means it was unable to create the file (could not find the
  318.      directory?). Only two beeps means it created the file, but could not
  319.      write the full screen buffer, (disk full?).
  320.  
  321.  
  322.  
  323.      Using GEMCAP                                                           3
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.      The size of the file GEMCAP creates depends on the current display
  332.      mode. 
  333.  
  334.      GEMCAP will detect the current video mode and adjust. It converts text
  335.      mode screens into bit mapped graphics.
  336.  
  337.      Like any other TSR, GEMCAP may have compatibility problems with other
  338.      software, especially other TSR's. If you have trouble, try installing
  339.      GEMCAP by itself and adding your other TSR utilities one at a time
  340.      after you get GEMCAP to work.
  341.  
  342.  
  343.      Customizing the Hot Key
  344.  
  345.      If you have a conflict with other resident programs, you may need to
  346.      change GEMCAP's hot key. You must use DEBUG to make the change. There
  347.      are two bytes in the GEMCAP.COM file that may be changed. The first
  348.      byte represents the keyboard scan code and the second byte represents
  349.      the shift key state. The following two tables show the values (in
  350.      hexadecimal) for all the possible keyboard scan codes and shift key
  351.      states. After consulting the tables, use DEBUG to enter the values as
  352.      shown below (for example to change the hot key to (Ctrl+Z):
  353.  
  354.         DEBUG GEMCAP.COM
  355.         E 0103
  356.         xxxx:0103 34.2C    ; shows existing scan code, enter new code: 2C
  357.                              (for 'Z')
  358.         E 0104
  359.         xxxx:0104 08.04    ; shows existing shift state, enter new code: 04
  360.                              (for 'Ctrl')
  361.         W                  ; save changes
  362.         Q                  ; quit DEBUG
  363.  
  364.  
  365.  
  366.      4                                                                  GEMCAP
  367.  
  368.  
  369.      This table shows keyboard scan codes for alternate hot keys:
  370.  
  371.                    Key       Hex    Key     Hex    Key       Hex
  372.                    -----     -----  -----   -----  -----     -----
  373.                    Esc        01    Enter    1C    PrtSc     37
  374.                    !1         02    Ctrl     1D    Alt       38
  375.                    @2         03    A        1E    Space     39
  376.                    #3         04    S        1F    CapLk     3A
  377.                    $4         05    D        20    F1        3B
  378.                    %5         06    F        21    F2        3C
  379.                    ^6         07    G        22    F3        3D
  380.                    &7         08    H        23    F4        3E
  381.                    *8         09    J        24    F5        3F
  382.                    (9         0A    K        25    F6        40
  383.                    )0         0B    L        26    F7        41
  384.                    _-         0C    :;       27    F8        42
  385.                    +=         0D    "'       28    F9        43
  386.                    backsp     0E    ~`       29    F10       44
  387.                    tab        0F    L Sft    2A    NumLk     45
  388.                    Q          10    |\       2B    ScrLk     46
  389.                    W          11    Z        2C    Home      47
  390.                    E          12    X        2D    Up        48
  391.                    R          13    C        2E    PgUp      49
  392.                    T          14    V        2F    -         4A
  393.                    Y          15    B        30    Left      4B
  394.                    U          16    N        31    5         4C
  395.                    I          17    M        32    Right     4D
  396.                    O          18    <,       33    +         4E
  397.                    P          19    >.       34    End       4F
  398.                    {[         1A    ?/       35    Down      50
  399.                    }]         1B    RSHFT    36    PgDn      51
  400.  
  401.      The following table shows the hexadecimal values for the possible
  402.      shift key states:
  403.  
  404.             Shift key value |   Alt |  Ctrl  |  Left  |  Right
  405.                             |       |        |  Shift |  Shift
  406.             ----------------+-------+--------+--------+-------
  407.                    0        |       |        |        |    
  408.                    1        |       |        |        |   *
  409.                    2        |       |        |   *    |
  410.                    4        |       |   *    |        |
  411.                    5        |       |   *    |        |   *
  412.                    6        |       |   *    |   *    |
  413.                    7        |       |   *    |   *    |   *
  414.                    8        |   *   |        |        |
  415.                    9        |   *   |        |        |   *
  416.                    A        |   *   |        |   *    |
  417.                    B        |   *   |        |   *    |   *
  418.                    C        |   *   |   *    |        |
  419.                    D        |   *   |   *    |        |   *
  420.                    E        |   *   |   *    |   *    |
  421.                    F        |   *   |   *    |   *    |   *
  422.             ----------------+-------+--------+--------+-------
  423.  
  424.      5                                                                 GEMCAP
  425.  
  426.  
  427.      Removing GEMCAP
  428.  
  429.      You can remove GEMCAP from memory by running GEMCAP with a command
  430.      line argument: -U (Un-install). for example:
  431.  
  432.           GEMCAP  -U
  433.  
  434.      GEMCAP must be the last TSR program loaded for this to work properly.
  435.      By removing and then reloading GEMCAP you can change the filename so
  436.      that you can save more than 26 screens.
  437.  
  438.  
  439.                                 Text Mode Screens
  440.  
  441.  
  442.      When the screen is in text mode when GEMCAP is run, it converts each
  443.      screen character to a bitmap. This means that when you display or
  444.      print the resulting GEM .IMG files with your desktop publishing
  445.      program, you will get exactly what is displayed on the screen.
  446.  
  447.      Text mode fonts
  448.  
  449.      With monochrome, CGA, or Hercules display adapters, an internal
  450.      (within GEMCAP.COM) 8 by 8 pixel font is used.
  451.  
  452.      On EGA or VGA display adapters, the RAM resident font (on the EGA or
  453.      VGA adapter) is used.
  454.  
  455.      GEMCAP does not produce color GEM .IMG files. It converts color
  456.      attributes to monochrome (Black & White) as described below.
  457.  
  458.      GEMCAP converts reverse video areas of the screen appropriately. Any
  459.      color attribute combination that results in darker characters with a
  460.      lighter background will be converted to reverse video. The following
  461.      color attribute combinations on the captured screen will result in
  462.      reverse video:
  463.  
  464.         any of these background  With these foreground
  465.         -----------------------  ---------------------
  466.         green                    black     grey
  467.         cyan                     blue      lt blue
  468.         brown                    red       lt red
  469.         white                    magenta   lt magenta
  470.  
  471.      If you wish to reverse the entire screen, for example from white on
  472.      black to black on white, load GEMCAP with the following command line
  473.      argument (-R) as shown below:
  474.  
  475.         GEMCAP -R C:\SCREENS\SCREENA.IMG
  476.  
  477.      GEMCAP will correctly capture different sized text mode screens. For
  478.      example, it can handle EGA text mode screens with 43 lines and VGA
  479.      text mode screens with 50 lines. It adjusts the internal pixel size so
  480.      that screens with different numbers of lines will display with the
  481.      correct aspect ratio.
  482.  
  483.      Text Mode                                                           6
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.      Image Size
  491.  
  492.      Note that with Ventura Publisher or WordPerfect 5.0, the size of the
  493.      image when incorporated into your document is dependent on the size of
  494.      the frame (VP) or figure (WP). For best results, you must adjust this
  495.      size (within VP or WP) so that pixels are not truncated or compressed.
  496.      You can calculate the best size for the image in your document based
  497.      on the horizontal and vertical resolution of your printer. For example
  498.      lets say you capture a VGA text mode screen that has 80 columns and 25
  499.      lines. The font size in this mode is 8 by 16 pixels. This means that
  500.      there are 400 (16 times 25) scan lines in the image and it is 640
  501.      pixels horizontally (80 times 8). You must size the image so that the
  502.      number of pixels in the image is evenly divisible by the printer
  503.      resolution. Therefore, if you have a laser printer or DeskJet printer
  504.      that prints at a resolution of 300 dots per inch (both horizontal and
  505.      vertical), a frame size  of 2.13 inches by 1.33, or 4.27 inches by
  506.      2.67 inches would produce non-distorted output. Note that you must
  507.      account for the inside border space and border width when sizing
  508.      figures in WordPerfect.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.      7                                                                 GEMCAP
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.                               Graphic Mode Screens
  547.  
  548.  
  549.      When the screen is in a graphics mode, GEMCAP stores the image pixel
  550.      by pixel in the GEM .IMG file. The most common high resolution graph-
  551.      ics modes of the various display adapters are supported as follows:
  552.  
  553.              CGA  640 x 200 x 2 color (mode 06h)
  554.              EGA  640 x 350 x 16 color (mode 10h)
  555.              VGA  640 x 480 x 16 color (mode 12h)
  556.  
  557.      Since GEMCAP does not produce color GEM .IMG files, when EGA/VGA 16
  558.      color modes are detected, it converts the color to monochrome (Black &
  559.      White) as described below.
  560.  
  561.              These dark colors are converted to Black:
  562.  
  563.                Black     Gray
  564.                Blue      Hi-intensity Blue
  565.                Green     Hi-intensity Green
  566.                Cyan      Hi-intensity Cyan
  567.  
  568.              These light colors are converted to White:
  569.  
  570.                Red       Hi-intensity Red
  571.                Violet    Hi-intensity Violet
  572.                Yellow    Hi-intensity Yellow
  573.                White     Hi-intensity White
  574.  
  575.      The size of the GEM .IMG file will vary. GEMCAP compresses the data in
  576.      the file as much as possible (for GEM .IMG file formats) by checking
  577.      for duplicate scan lines in the original image. The more complex the
  578.      image, the larger the file size.
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.      Graphics Mode                                                         8
  593.  
  594.